Inside Macintosh: QuickTime Components /

Chapter 6 - Sequence Grabber Channel Components / Sequence Grabber Channel Components Reference

Functions / Utility Functions for Sequence Grabber Channel Components

SGSortDeviceList

The SGSortDeviceList function allows you to sort your device list alphabetically.

pascal ComponentResult SGSortDeviceList (SeqGrabComponent s, 
                                          SGDeviceList list);

s

Specifies the component instance that identifies the sequence grabber component that is using your channel. The sequence grabber provides this to you when it calls your SGInitChannel function (described on page 6-36).

list

Contains a pointer to a device list structure pointer.

DESCRIPTION

Your component constructs its device list whenever the sequence grabber calls your SGGetChannelDeviceList function (described on page 6-57). You may add entries to the device list in any order you like. Once you have built up your device list, you may use the SGSortDeviceList function to sort that list alphabetically, by device name. The sequence grabber correctly updates the selectedIndex field in the device list structure, as well.

The format and content of the device list structure are discussed earlier in this chapter, in "Working With Channel Devices" beginning on page 6-55.

RESULT CODE

paramErr

-50

Invalid parameter value

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help